home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr31 / zipcom11.zip / ZIPCOM.DOC < prev    next >
Text File  |  1993-05-05  |  7KB  |  144 lines

  1.                                 ZIPCOM v1.1
  2.  
  3.                         (c) 1989 Dr. R. B. Hamilton
  4.         Shadowland BBS (306) 789-8989 8-N-1 24H 300/1200/2400 Baud
  5.                                 No Fee's!!!
  6.  
  7. Welcome to another of those goofy little utilities that I write from time
  8. to time.  This one started the other night.  Some user uploaded a neat 
  9. little package called ARCUP to my BBS.  I unZIPed the file and saw one of 
  10. those interesting adds for the BBS where the file was downloaded from. 
  11. The trouble was that this was a program that I had written and here it 
  12. contained an ad for another BBS!!!  Well something had to be done!  I 
  13. poured over my PKZIP manual and discovered the Z command.  With some work
  14. I managed to remove the ad for the other BBS (not that I minded the ad 
  15. being there, but after all, this was MY work we were talking about) and 
  16. slowly figured a way to add a text file to the ARCUP ZIP. 
  17.  
  18. Whew!  There had to be another way to do this with less bother!  Thus was 
  19. born ZIPCOM.  The utility that adds comments to ZIP files with no fuss no 
  20. bother and no mess.
  21.  
  22. I should say that I had nothing to do with the writing of PKZIP but it 
  23. just has to be one of the greatest utilities ever.  You should register 
  24. it if you haven't already!  If you don't have PKZIP then I guess you 
  25. won't be reading this text file since it is ZIPed, but if you need a 
  26. copy, you can download PKZIP from Shadowland BBS.  ZIPCOM is designed to 
  27. work only with PKZIP version 1 and above.  It does not seem to work with 
  28. version 0.9 or other beta versions.  Then again, you must have the newest 
  29. version or you couldn't unImplode this file, now could you? MAKE SURE 
  30. PKZIP IS IN THE DEFAULT DIRECTORY OR ON THE PATH - THIS PROGRAM CALLS 
  31. PKZIP!  (I am talking about PKZIP.EXE not PKUNZIP!)
  32.  
  33. The basic idea is a simple one.  You write up a simple text file using
  34. either a text editor or if you want to get fancy, an ANSI editor.  Once
  35. you have your text file, you run ZIPCOM and ZIPCOM will add the comment
  36. file to any or all ZIP's in the directory you specify.  When the file
  37. is viewed or unZIPed, the user will see your comments displayed on the
  38. screen.  Perhaps an add for the BBS you got the file from, or whatever.
  39. If you need a good ANSI editor, try ANSI-LA.  It and other ANSI editors
  40. are also available on Shadowland BBS.  If you need a good TEXT editor 
  41. give SLED a try.  It's on Shadowland too.
  42.  
  43. Once you have your ASCII text file, type it to the screen and see how it 
  44. is going to look.  Use this command (but substitute your own text file 
  45. name for TEXT.TXT).
  46.  
  47. C:\> TYPE TEXT.TXT
  48.  
  49. If the text file looks the way you want it, you are set.  If not, go back 
  50. to the drawing board.  Most ANSI and text editors can output in ASCII or 
  51. in other format's so make sure to use ASCII output.
  52.  
  53. Enclosed with this ZIP you will find a sample file called SHADOW.TXT.  
  54. It was produced with my favorite ANSI editor but I declined to include
  55. color.  The reason is that in order to produce a text file that changes
  56. color you have to send ANSI codes to your screen.  If a person is 
  57. running ANSI.SYS he will see wonderful color.  If not, he sees jibberish
  58. and might think he is being struck by a virus or something.  Anyway
  59. color or plain text, it's all up to you.  If you are using color, you
  60. must make sure your users are aware that they will require ANSI.SYS
  61. in order to view the comment.
  62.  
  63. Place ZIPCOM and your text file in a handy directory.  ZIPCOM must be 
  64. in either the default directory or on the path.  
  65.  
  66. You now have the option of running ZIPCOM in interactive mode (ZIPCOM 
  67. will prompt you for file names) or in command line mode.
  68.  
  69. From the command line you would type:
  70.  
  71. C:\> zipcom filespec.zip filename.ext
  72.  
  73. Where Filespec.zip is the standard DOS file/path specification for the 
  74. ZIP files to which you wish to add text file filename.ext
  75.  
  76. ZIPCOM will search out and find anything matching filespec.ZIP.  The 
  77. inclusion of an extension .ZIP is very important.  For obvious reasons 
  78. you can only add ZIP comments to a ZIP file.  Otherwise any normal 
  79. file/path name will work perfectly, including wild cards.
  80.  
  81. Filename.ext is the name of your text file in ASCII which you would 
  82. like to add as a comment to the ZIP files.  Here are some examples:
  83.  
  84. C:\> ZIPCOM *.ZIP SHADOW.TXT
  85. C:\> ZIPCOM C:\DOWNLOAD\E*.ZIP SHADOW.TXT
  86. C:\> ZIPCOM D:\UTIL\*.ZIP C:\TEXT\SHADOW.TXT
  87.  
  88. If you would rather, ZIPCOM provides a fairly friendly user interface 
  89. which will prompt you along.  To run ZIPCOM in interactive mode just 
  90. type  ZIPCOM and then press <Enter> (ie run it without command line 
  91. arguments).
  92.  
  93. Once you run ZIPCOM you will be asked the name of your text file.  At 
  94. this point, you would type in the full file/path name of your comment 
  95. text file.  For example C:\ASCII\SHADOW.TXT.
  96.  
  97. Next you will be asked for the name of the files you wish to add the 
  98. comment to.  For example C:\FILES\*.ZIP  or C:\DOWNLOAD\A??UP.ZIP or just 
  99. C:\STUFF\FILE.ZIP.  Any valid file name will work, including wild cards.
  100.  
  101. For obvious reasons, all files specified must be ZIP files and must have 
  102. the ZIP extension.  The ZIP file must already exist so if you have some 
  103. EXE files that you want to ZIP and then add a comment, you must ZIP them 
  104. first (read your PKZIP manual on how to do this).
  105.  
  106. Once you have entered the text file and the ZIP files to add the text 
  107. file to, you are set.  Sit back and watch.  ZIPCOM will first of all 
  108. locate all the files that match your ZIP selections.  It will then 
  109. prepare a BATch file to preform the operations needed.  It will then 
  110. execute the batch file and then it will delete the batch file so as not 
  111. to clutter up your hard drive (or diskette).
  112.  
  113. That's about it.  When you use PKZIP -V FILE.ZIP you should see the ad 
  114. you placed in the ZIP.  You will also see it when you unZIP a file.
  115.  
  116. I guess I should provide a note of warning or common sense or something 
  117. here.  If a program author has included a comment in a ZIP file then if 
  118. you remove that comment (which ZIPCOM will do) you may be in violation of 
  119. his copywrite.  Worse yet, that comment might contain valuable 
  120. information.  Please use your head before you use ZIPCOM and there should 
  121. be no problems.
  122.  
  123. Now for the nasty stuff.  This program is copywrite and modification to 
  124. this program, distribution of this ZIP file with any sort of 
  125. modification, or inclusion of this file with other programs (like disk 
  126. distribution services, commercial software, etc.) constitues a violation 
  127. of my copywrite and I will hunt you down and kill you if you try it.  
  128. Public Access BBS's are free to post this file for download and use it.  
  129. Commercial BBS services must call and beg me in order to use this program 
  130. or post it for download.  Everyone else feel free to use this program to 
  131. suit your needs.
  132.  
  133. I don't want your money.  All I ask is that if you use this program and 
  134. find it to be of any value to you, please call Shadowland BBS (see above) 
  135. and let me know.  If you have written any small utilities or you have 
  136. some hard to find utilities, please send them in (PD or ShareWare ONLY 
  137. please!).
  138.  
  139. As a final note, PLEASE don't modify the comment on the ZIPCOM.ZIP file.  
  140. I don't think it's unreasonable to ask for a bit of advertizing space in 
  141. return for the use of this program.
  142.  
  143. I hope you enjoy ZIPCOM!
  144.